<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>XML utility functions</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.0">
<link rel="home" href="index.html" title="libinfinity-0.4 Reference Manual">
<link rel="up" href="ch02.html" title="Common libinfinity API">
<link rel="prev" href="libinfinity-0.4-InfCertificateChain.html" title="InfCertificateChain">
<link rel="next" href="libinfinity-0.4-InfCertUtil.html" title="InfCertUtil">
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libinfinity-0.4-InfCertificateChain.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">libinfinity-0.4 Reference Manual</th>
<td><a accesskey="n" href="libinfinity-0.4-InfCertUtil.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#libinfinity-0.4-InfXmlUtil.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#libinfinity-0.4-InfXmlUtil.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry" title="XML utility functions">
<a name="libinfinity-0.4-InfXmlUtil"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libinfinity-0.4-InfXmlUtil.top_of_page"></a>XML utility functions</span></h2>
<p>XML utility functions — Helper functions to read basic data types from XML</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" title="Stability Level">
<a name="libinfinity-0.4-InfXmlUtil.stability-level"></a><h2>Stability Level</h2>
Unstable, unless otherwise indicated
</div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="libinfinity-0.4-InfXmlUtil.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;libinfinity/common/inf-xml-util.h&gt;

<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-add-child-text" title="inf_xml_util_add_child_text ()">inf_xml_util_add_child_text</a>         (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> bytes</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-child-text" title="inf_xml_util_get_child_text ()">inf_xml_util_get_child_text</a>         (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *bytes</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *chars</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<span class="returnvalue">xmlChar</span> *           <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute" title="inf_xml_util_get_attribute ()">inf_xml_util_get_attribute</a>          (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>);
<span class="returnvalue">xmlChar</span> *           <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-required" title="inf_xml_util_get_attribute_required ()">inf_xml_util_get_attribute_required</a> (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int" title="inf_xml_util_get_attribute_int ()">inf_xml_util_get_attribute_int</a>      (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int-required" title="inf_xml_util_get_attribute_int_required ()">inf_xml_util_get_attribute_int_required</a>
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-long" title="inf_xml_util_get_attribute_long ()">inf_xml_util_get_attribute_long</a>     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-long-required" title="inf_xml_util_get_attribute_long_required ()">inf_xml_util_get_attribute_long_required</a>
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-uint" title="inf_xml_util_get_attribute_uint ()">inf_xml_util_get_attribute_uint</a>     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-uint-required" title="inf_xml_util_get_attribute_uint_required ()">inf_xml_util_get_attribute_uint_required</a>
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-ulong" title="inf_xml_util_get_attribute_ulong ()">inf_xml_util_get_attribute_ulong</a>    (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-ulong-required" title="inf_xml_util_get_attribute_ulong_required ()">inf_xml_util_get_attribute_ulong_required</a>
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-double" title="inf_xml_util_get_attribute_double ()">inf_xml_util_get_attribute_double</a>   (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-double-required" title="inf_xml_util_get_attribute_double_required ()">inf_xml_util_get_attribute_double_required</a>
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute" title="inf_xml_util_set_attribute ()">inf_xml_util_set_attribute</a>          (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute-int" title="inf_xml_util_set_attribute_int ()">inf_xml_util_set_attribute_int</a>      (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute-long" title="inf_xml_util_set_attribute_long ()">inf_xml_util_set_attribute_long</a>     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute-uint" title="inf_xml_util_set_attribute_uint ()">inf_xml_util_set_attribute_uint</a>     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute-ulong" title="inf_xml_util_set_attribute_ulong ()">inf_xml_util_set_attribute_ulong</a>    (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-set-attribute-double" title="inf_xml_util_set_attribute_double ()">inf_xml_util_set_attribute_double</a>   (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);
</pre>
</div>
<div class="refsect1" title="Description">
<a name="libinfinity-0.4-InfXmlUtil.description"></a><h2>Description</h2>
<p>
In the infinote protocol XML attributes are often required to contain
numbers. These function provide some convenience to set and retrieve them.
They are mostly used in libinfinity itself but can also be useful when
implementing new session types so they are public API.
</p>
</div>
<div class="refsect1" title="Details">
<a name="libinfinity-0.4-InfXmlUtil.details"></a><h2>Details</h2>
<div class="refsect2" title="inf_xml_util_add_child_text ()">
<a name="inf-xml-util-add-child-text"></a><h3>inf_xml_util_add_child_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_add_child_text         (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> bytes</code></em>);</pre>
<p>
Adds the given text as child text to <em class="parameter"><code>xml</code></em> in the same way
<code class="function">xmlNodeAddContentLen()</code> would do. The difference is that <em class="parameter"><code>text</code></em> is allowed
to contain characters that are not valid in
<a class="ulink" href="http://www.w3.org/TR/REC-xml/#dt-text" target="_top">XML text</a>, such
as formfeed characters \f. In case one occurs in <em class="parameter"><code>text</code></em>, the function adds
an &lt;uchar /&gt; element node instead to <em class="parameter"><code>xml</code></em> as specified in the
infinote protocol.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>The child text to add.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
<td>The number of bytes of <em class="parameter"><code>text</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_child_text ()">
<a name="inf-xml-util-get-child-text"></a><h3>inf_xml_util_get_child_text ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             inf_xml_util_get_child_text         (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *bytes</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *chars</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Reads a node's child text. If there are &lt;uchar /&gt; child elements, as
added by <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-add-child-text" title="inf_xml_util_add_child_text ()"><code class="function">inf_xml_util_add_child_text()</code></a> this function will convert them
back to character codes. There should not be any other child elements in
<em class="parameter"><code>xml</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
<td>Location to store number of bytes of child text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>chars</code></em> :</span></p></td>
<td>Location to store number of characters of child text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Locatian to store error information if any, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The node's child text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when
no longer needed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute ()">
<a name="inf-xml-util-get-attribute"></a><h3>inf_xml_util_get_attribute ()</h3>
<pre class="programlisting"><span class="returnvalue">xmlChar</span> *           inf_xml_util_get_attribute          (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>);</pre>
<p>
Returns the value of the attribute called <em class="parameter"><code>attribute</code></em> in the XML element
<em class="parameter"><code>xml</code></em>. This function is a thin wrapper around <code class="function">xmlGetProp()</code> which exists
mostly for consistency, and for not having to cast the <em class="parameter"><code>attribute</code></em> argument
from char* to xmlChar*. The return value is a xmlChar*, though.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The value of the attribute, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Free with <code class="function">xmlFree()</code> when no
longer needed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_required ()">
<a name="inf-xml-util-get-attribute-required"></a><h3>inf_xml_util_get_attribute_required ()</h3>
<pre class="programlisting"><span class="returnvalue">xmlChar</span> *           inf_xml_util_get_attribute_required (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Returns the value of the attribute called <em class="parameter"><code>attribute</code></em> in the XML element
<em class="parameter"><code>xml</code></em>. If there is no such attribute then the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and
<em class="parameter"><code>error</code></em> is set.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The attribute's value, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free with <code class="function">xmlFree()</code>
when no longer needed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_int ()">
<a name="inf-xml-util-get-attribute-int"></a><h3>inf_xml_util_get_attribute_int ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_int      (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Reads the attribute named <em class="parameter"><code>attribute</code></em> from the XML element <em class="parameter"><code>xml</code></em>. The
attribute value is expected to be a signed integral number. If it is the
function converts the text to an integere and stores the result into
<em class="parameter"><code>result</code></em>. In this case, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned and <em class="parameter"><code>error</code></em> is left untouched.
</p>
<p>
If the value is not a signed integral number, then the function returns
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, <em class="parameter"><code>error</code></em> is set and <em class="parameter"><code>result</code></em> is left untouched.
</p>
<p>
If the attribute does not exist the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> but <em class="parameter"><code>error</code></em> is
not set.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_int_required ()">
<a name="inf-xml-util-get-attribute-int-required"></a><h3>inf_xml_util_get_attribute_int_required ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_int_required
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Reads the attribute named <em class="parameter"><code>attribute</code></em> from the XML element <em class="parameter"><code>xml</code></em>. The
attribute value is expected to be a signed integral number. If it is the
function converts the text to an integere and stores the result into
<em class="parameter"><code>result</code></em>. In this case, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned and <em class="parameter"><code>error</code></em> is left untouched.
</p>
<p>
If the value is not a signed integral number or the attribute does not
exist, then the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, <em class="parameter"><code>error</code></em> is set and <em class="parameter"><code>result</code></em> is
left untouched.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_long ()">
<a name="inf-xml-util-get-attribute-long"></a><h3>inf_xml_util_get_attribute_long ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_long     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int" title="inf_xml_util_get_attribute_int ()"><code class="function">inf_xml_util_get_attribute_int()</code></a>. The only difference
is that the function reads a signed long integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_long_required ()">
<a name="inf-xml-util-get-attribute-long-required"></a><h3>inf_xml_util_get_attribute_long_required ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_long_required
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int-required" title="inf_xml_util_get_attribute_int_required ()"><code class="function">inf_xml_util_get_attribute_int_required()</code></a>. The only
difference is that the function reads a signed long integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_uint ()">
<a name="inf-xml-util-get-attribute-uint"></a><h3>inf_xml_util_get_attribute_uint ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_uint     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int" title="inf_xml_util_get_attribute_int ()"><code class="function">inf_xml_util_get_attribute_int()</code></a>. The only difference
is that the function reads an unsigned integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_uint_required ()">
<a name="inf-xml-util-get-attribute-uint-required"></a><h3>inf_xml_util_get_attribute_uint_required ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_uint_required
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int-required" title="inf_xml_util_get_attribute_int_required ()"><code class="function">inf_xml_util_get_attribute_int_required()</code></a>. The only
difference is that the function reads an unsigned integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_ulong ()">
<a name="inf-xml-util-get-attribute-ulong"></a><h3>inf_xml_util_get_attribute_ulong ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_ulong    (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int" title="inf_xml_util_get_attribute_int ()"><code class="function">inf_xml_util_get_attribute_int()</code></a>. The only difference
is that the function reads an unsigned long integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_ulong_required ()">
<a name="inf-xml-util-get-attribute-ulong-required"></a><h3>inf_xml_util_get_attribute_ulong_required ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_ulong_required
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int-required" title="inf_xml_util_get_attribute_int_required ()"><code class="function">inf_xml_util_get_attribute_int_required()</code></a>. The only
difference is that the function reads an unsigned long integral number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_double ()">
<a name="inf-xml-util-get-attribute-double"></a><h3>inf_xml_util_get_attribute_double ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_double   (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int" title="inf_xml_util_get_attribute_int ()"><code class="function">inf_xml_util_get_attribute_int()</code></a>. The only difference
is that the function reads a double-precision floating point number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_get_attribute_double_required ()">
<a name="inf-xml-util-get-attribute-double-required"></a><h3>inf_xml_util_get_attribute_double_required ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_xml_util_get_attribute_double_required
                                                        (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *result</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>
Behaves exactly like <a class="link" href="libinfinity-0.4-InfXmlUtil.html#inf-xml-util-get-attribute-int-required" title="inf_xml_util_get_attribute_int_required ()"><code class="function">inf_xml_util_get_attribute_int_required()</code></a>. The only
difference is that the function reads a double-precision floating point
number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to query.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td>Location to store the read value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Location to store error information, if any.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>result</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute ()">
<a name="inf-xml-util-set-attribute"></a><h3>inf_xml_util_set_attribute ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute          (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given value of the XML element
<em class="parameter"><code>xml</code></em>. This is a thin wrapper around <code class="function">xmlSetProp()</code>, mainly provided for
consistency and for not having to cast the arguments to xmlChar*.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute_int ()">
<a name="inf-xml-util-set-attribute-int"></a><h3>inf_xml_util_set_attribute_int ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute_int      (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given signed integral value
converted to text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute_long ()">
<a name="inf-xml-util-set-attribute-long"></a><h3>inf_xml_util_set_attribute_long ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute_long     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given signed long integral value
converted to text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute_uint ()">
<a name="inf-xml-util-set-attribute-uint"></a><h3>inf_xml_util_set_attribute_uint ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute_uint     (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given unsigned integral value
converted to text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute_ulong ()">
<a name="inf-xml-util-set-attribute-ulong"></a><h3>inf_xml_util_set_attribute_ulong ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute_ulong    (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given unsigned long integral
value converted to text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_xml_util_set_attribute_double ()">
<a name="inf-xml-util-set-attribute-double"></a><h3>inf_xml_util_set_attribute_double ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_xml_util_set_attribute_double   (<em class="parameter"><code><span class="type">xmlNodePtr</span> xml</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
<p>
Sets the attribute named <em class="parameter"><code>attribute</code></em> to the given double-precision
floating point number converted to text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xml</code></em> :</span></p></td>
<td>A <span class="type">xmlNodePtr</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
<td>The name of the attribute to set.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to set.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15</div>
</body>
</html>